package com.ideaaedi.springcloud.jd.user.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.ideaaedi.springcloud.jd.commonds.entity.PageInfo;
import com.ideaaedi.springcloud.jd.commonds.entity.user.bo.ApiInfoBO;
import com.ideaaedi.springcloud.jd.commonds.entity.user.po.SysApiResourcePO;
import com.ideaaedi.springcloud.jd.commonds.entity.user.vo.req.SysApiResourceListReqVO;
import com.ideaaedi.springcloud.jd.commonds.entity.user.vo.req.SysRoleBindApiReqVO;
import com.ideaaedi.springcloud.jd.commonds.entity.user.vo.resp.SysApiResourceDetailRespVO;
import com.ideaaedi.springcloud.jd.commonds.entity.user.vo.resp.SysApiResourceListRespVO;
import org.apache.ibatis.annotations.Param;
import org.springframework.lang.Nullable;

import java.util.LinkedHashSet;
import java.util.List;
import java.util.Set;

/**
 * <p>
 * 系统-api资源 服务类
 * </p>
 *
 * @author <font size = "20" color = "#3CAA3C"><a href="https://gitee.com/JustryDeng">JustryDeng</a></font> <img
 * src="https://gitee.com/JustryDeng/shared-files/raw/master/JustryDeng/avatar.jpg" />
 * @since 2021.0.5.B
 */
public interface SysApiResourceService extends IService<SysApiResourcePO> {
    
    /**
     * 查详情
     *
     * @param id 要查询数据的id
     *
     * @return 数据详情
     */
    @Nullable
    SysApiResourceDetailRespVO detail(Long id);
    
    /**
     * 查列表
     *
     * @param req 参数
     *
     * @return 数据列表
     */
    PageInfo<SysApiResourceListRespVO> list(SysApiResourceListReqVO req);
    
    /**
     * 给角色绑定api资源
     *
     * @param req 请求模型
     *
     * @return 操作是否成功
     */
    List<SysApiResourceListRespVO> bindApi(SysRoleBindApiReqVO req);
    
    /**
     * 根据角色获取可访问的api
     *
     * @param roles 角色
     *
     * @return 可访问的endpoint集合
     */
    List<SysApiResourceListRespVO> queryApi(@Nullable Set<Long> roles);
    
    
    /**
     * 查询用户直接拥有的所有api简讯
     *
     * @param userId 用户id
     *
     * @return 用户直接拥有的所有api简讯
     */
    LinkedHashSet<ApiInfoBO> listUserApi(@Nullable Long userId);
    
    /**
     * 根据角色获取可访问的api(简化信息)
     *
     * @param roles 角色
     *
     * @return 可访问的endpoint集合
     */
    LinkedHashSet<ApiInfoBO> queryApiSimplify(@Nullable @Param("roles") Set<Long> roles);
}
